home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / disk / misc / Mtools207.readme < prev    next >
Encoding:
Text File  |  1994-06-28  |  13.1 KB  |  263 lines
  1. Short: Mtools V2.0.7 for AmigaDOS
  2. Type: disk/misc
  3.  
  4. Mtools 2.0.7 for AmigaDOS
  5. -------------------------
  6.  
  7. Why use Mtools instead of CrossDOS?
  8. -----------------------------------
  9.  
  10. CrossDOS is nice in most cases, but inusable in others:
  11.  
  12. - you cannot correctly write to MS-DOS partitions > 30MB
  13.   with CrossDOS, Mtools allow you this.
  14.  
  15. - CrossDOS is VERY SLOW when writing large files to devices such
  16.   as MO-Drives, it seems to be lacking reasonable write-caching.
  17.   Mtools are magnitudes faster in those cases.
  18.  
  19.   (but CrossDOS is much faster than Mtools in writing many
  20.    small files)
  21.  
  22. What do you need to use Mtools on your Amiga?
  23. ---------------------------------------------
  24.  
  25. - You need to have the ixemul.library (by Markus Wild)
  26.   installed, you may find it where other PD-Soft, especially
  27.   gcc, is available.
  28.   You may use the command "ixconfig -i" to speed the
  29.   startup of the programs (ixemul.library else scans
  30.   all the environment variables...)
  31.  
  32. - If the media you'd like to access via Mtools differs from
  33.   the ones I have available (and preconfigured), you'll
  34.   need to edit the first structure in devices.c a little,
  35.   then compile the programs by saying "make" again, you'll
  36.   need gcc and the C=-includes to do this.
  37.   (see also the config-notes below)
  38.  
  39. Are there any problems with Mtools (in comparison to the unix-version)?
  40. -----------------------------------------------------------------------
  41.  
  42. Yes, there are. But nothing really serious: The command "mcopy"
  43. determines the direction of the copy (from/to MS-DOS) by looking
  44. at the destination name. Since MS-DOS also uses the colon to separate
  45. a device-name, mcopy will think you want to copy from AmigaDOS to
  46. MS-DOS if you give for example the command
  47.  
  48. mcopy a:foo.bar t:
  49.  
  50. ... so avoid the colon in the destination path, and use the unix-syntax:
  51.  
  52. mcopy a:foo.bar /t/
  53.  
  54. ... which will do what you wanted it to do.
  55.  
  56. You may also use (AmigaDOS-)wildcards in the source-name(s), if you
  57. want to copy from AmigaDOS to MS-DOS, e.g.:
  58.  
  59. mcopy #?.bar a:
  60.  
  61. *BUT* if you want to copy in the opposite direction, from MS-DOS to
  62. AmigaDOS, you need to use a different syntax:
  63.  
  64. mcopy "a:*.bar" /t/
  65.  
  66. Conclusion: 
  67.  
  68. ADOS->MSDOS:  AmigaDOS-wildcards, no double-quotes needed
  69. MSDOS->Amiga: MSDOS-wildcards, double-quotes around the source-name(s) needed
  70.  
  71. IMPORTANT: Due to the limitations of the CLI-parameter length you
  72. shouldn't use the wildcard expansion on the Amiga-side with very
  73. large numbers of matching files - an error may occur.
  74.  
  75. Are Mtools able to format MS-DOS media?
  76. ---------------------------------------
  77.  
  78. LOW-LEVEL:  NO!
  79. HIGH-LEVEL: SOMETIMES... you may use mformat to write the
  80.             FAT etc. to a low-level-formatted (floppy-)disk,
  81.             but mformat is unable to write the FAT on great
  82.             partitions.
  83.  
  84. I've included an archive with the compressed initial data
  85. for an 128MB MO-medium, you may "format" such an medium
  86. by writing the data directly to appropriate device.
  87.  
  88. If you've got a copy of "dcp" for example, you may say
  89.  
  90. lha e MSDOS_128MB_FAT.lha
  91. dcp MSDOS_MO_BLOCKS <your device:>
  92.  
  93. You can create archives with appropriate FATs for your media
  94. by formatting them with an PeeeCeee, then read the FAT-blocks
  95. from the device (for example with dcp, too).
  96.  
  97.  
  98. How can I customize Mtools to work with my special hardware?
  99. ------------------------------------------------------------
  100.  
  101. Read the file src/Configure, then you'll be able to change the
  102. src/devices.c file as you need it. But you'll also need to know
  103. a few additional things:
  104.  
  105. - In the unix-version, all the I/O is done via (special-)files.
  106.   You may do this, too, by using the "flat:"-device (was
  107.   published on fish-disks), and the appropriate filename
  108.   in devices.c.
  109.   But there's a better I/O method, which is only available
  110.   in this Amiga-version of the Mtools: You may also specify the
  111.   name and the unit of a device, then this device will be used
  112.   directly.
  113.  
  114.   device->name  then holds the name of the device,
  115.   device->mode  holds the unit-number,
  116.   device->heads must be set to -1 for a device (rather than a file)
  117.  
  118. - The device->tracks, heads and sectors are optional parameters,
  119.   you may set them to 0 if you don't know them. If you know them for sure,
  120.   set them, this will make the read & write caching more efficient.
  121.   If you're using a device (thus device->heads == -1), you may set
  122.   the sector-number to the number of blocks you wish to fit into the caches.
  123.   If you don't, a default-value of 128 blocks is the size of the caches.
  124.  
  125.  
  126. Credits:
  127. --------
  128.  
  129. The Amiga-specific changes to Mtools were applied by
  130.   Lutz Vieweg <lkv@mania.robin.de>
  131.  
  132. The device-access code was taken from the "device-streams.tar.gz"
  133.   archive by Christian E. Hopps
  134.  
  135. THANKS TO THE AUTHORS OF THE ORIGINAL MTOOLS, OF COURSE!
  136.  
  137.  
  138.  
  139. ============================= Archive contents =============================
  140.  
  141. Original  Packed Ratio    Date     Time    Name
  142. -------- ------- ----- --------- --------  -------------
  143.    21984   12739 42.0% 27-May-94 21:47:52  Mtools-2.0.7/Amiga_executables/mattrib
  144.    12720    7286 42.7% 27-May-94 21:47:58  Mtools-2.0.7/Amiga_executables/mcd
  145.     4136    2505 39.4% 27-May-94 20:59:04  Mtools-2.0.7/Amiga_executables/mcopy
  146.    22792   13124 42.4% 27-May-94 21:48:04  Mtools-2.0.7/Amiga_executables/mdel
  147.    14336    8220 42.6% 27-May-94 21:48:10  Mtools-2.0.7/Amiga_executables/mdir
  148.    14324    8688 39.3% 27-May-94 21:00:20  Mtools-2.0.7/Amiga_executables/mformat
  149.     2264    1487 34.3% 27-May-94 21:03:12  Mtools-2.0.7/Amiga_executables/mkmanifest
  150.    20612   11968 41.9% 27-May-94 21:48:16  Mtools-2.0.7/Amiga_executables/mlabel
  151.    23660   13544 42.7% 27-May-94 21:48:22  Mtools-2.0.7/Amiga_executables/mmd
  152.    22952   13143 42.7% 27-May-94 21:48:28  Mtools-2.0.7/Amiga_executables/mrd
  153.    21728   12871 40.7% 27-May-94 21:48:34  Mtools-2.0.7/Amiga_executables/mread
  154.    21992   12717 42.1% 27-May-94 21:48:40  Mtools-2.0.7/Amiga_executables/mren
  155.    13616    7943 41.6% 27-May-94 21:48:46  Mtools-2.0.7/Amiga_executables/mtype
  156.    26424   14975 43.3% 27-May-94 21:48:52  Mtools-2.0.7/Amiga_executables/mwrite
  157.     1470     683 53.5% 27-May-94 14:07:50  Mtools-2.0.7/docs/Mattrib.doc
  158.     1068     533 50.0% 27-May-94 14:08:32  Mtools-2.0.7/docs/Mcd.doc
  159.     1941     862 55.5% 27-May-94 14:17:18  Mtools-2.0.7/docs/Mcopy.doc
  160.     1007     524 47.9% 27-May-94 14:10:12  Mtools-2.0.7/docs/Mdel.doc
  161.     1156     572 50.5% 27-May-94 14:10:40  Mtools-2.0.7/docs/Mdir.doc
  162.     1077     497 53.8% 27-May-94 14:11:02  Mtools-2.0.7/docs/Mformat.doc
  163.     2008     793 60.5% 27-May-94 14:11:40  Mtools-2.0.7/docs/Mkmanifest.doc
  164.      761     383 49.6% 27-May-94 14:12:02  Mtools-2.0.7/docs/Mlabel.doc
  165.     1241     610 50.8% 27-May-94 14:12:24  Mtools-2.0.7/docs/Mmd.doc
  166.      853     450 47.2% 27-May-94 14:12:48  Mtools-2.0.7/docs/Mrd.doc
  167.     1515     702 53.6% 27-May-94 14:13:24  Mtools-2.0.7/docs/Mread.doc
  168.     1387     656 52.7% 27-May-94 14:13:56  Mtools-2.0.7/docs/Mren.doc
  169.     3114    1370 56.0% 27-May-94 14:14:36  Mtools-2.0.7/docs/Mtools.doc
  170.     1081     548 49.3% 27-May-94 14:14:58  Mtools-2.0.7/docs/Mtype.doc
  171.     1835     824 55.0% 27-May-94 14:16:22  Mtools-2.0.7/docs/Mwrite.doc
  172.      830     830  0.0% 27-May-94 13:57:48  Mtools-2.0.7/MSDOS_128MB_FAT.lha
  173.     3863    1362 64.7% 27-May-94 20:40:20  Mtools-2.0.7/src/amiga_devices.c
  174.     2146     913 57.4% 27-May-94 17:16:08  Mtools-2.0.7/src/amiga_devices.h
  175.     1410     711 49.5% 27-May-94 20:58:14  Mtools-2.0.7/src/amiga_devices.o
  176.     2255     828 63.2% 27-May-94 18:41:22  Mtools-2.0.7/src/buf_read.c
  177.     1363     651 52.2% 27-May-94 18:50:22  Mtools-2.0.7/src/buf_read.o
  178.     3587    1203 66.4% 27-May-94 18:57:06  Mtools-2.0.7/src/buf_write.c
  179.     2194     987 55.0% 27-May-94 20:54:58  Mtools-2.0.7/src/buf_write.o
  180.     6255    2289 63.4% 26-May-94 17:29:08  Mtools-2.0.7/src/Configure
  181.     5081    1227 75.8% 27-May-94 19:11:10  Mtools-2.0.7/src/devices.c
  182.      222     118 46.8% 27-May-94 20:55:06  Mtools-2.0.7/src/devices.o
  183.     2038     908 55.4% 26-May-94 17:29:10  Mtools-2.0.7/src/dir_make.c
  184.     1336     709 46.9% 26-May-94 17:38:02  Mtools-2.0.7/src/dir_make.o
  185.     3350    1271 62.0% 26-May-94 17:29:10  Mtools-2.0.7/src/dir_read.c
  186.     2152    1084 49.6% 26-May-94 17:33:24  Mtools-2.0.7/src/dir_read.o
  187.     4191    1634 61.0% 26-May-94 17:29:12  Mtools-2.0.7/src/dir_write.c
  188.     2481    1355 45.3% 27-May-94 20:55:26  Mtools-2.0.7/src/dir_write.o
  189.     1738     845 51.3% 26-May-94 17:29:12  Mtools-2.0.7/src/expand.c
  190.      839     517 38.3% 27-May-94 20:55:36  Mtools-2.0.7/src/expand.o
  191.      728     405 44.3% 26-May-94 17:29:12  Mtools-2.0.7/src/fat_free.c
  192.      431     258 40.1% 26-May-94 17:36:14  Mtools-2.0.7/src/fat_free.o
  193.     3244    1203 62.9% 27-May-94 15:10:42  Mtools-2.0.7/src/fat_read.c
  194.     1092     602 44.8% 27-May-94 15:10:58  Mtools-2.0.7/src/fat_read.o
  195.     2524     938 62.8% 26-May-94 17:29:08  Mtools-2.0.7/src/fat_write.c
  196.      917     503 45.1% 27-May-94 20:59:24  Mtools-2.0.7/src/fat_write.o
  197.     1823     773 57.5% 26-May-94 17:29:08  Mtools-2.0.7/src/file_read.c
  198.      896     553 38.2% 27-May-94 21:01:44  Mtools-2.0.7/src/file_read.o
  199.     2343     954 59.2% 26-May-94 17:29:08  Mtools-2.0.7/src/file_write.c
  200.     1188     679 42.8% 27-May-94 21:02:52  Mtools-2.0.7/src/file_write.o
  201.     9468    3402 64.0% 27-May-94 19:09:44  Mtools-2.0.7/src/init.bak
  202.     9474    3408 64.0% 27-May-94 21:47:14  Mtools-2.0.7/src/init.c
  203.     5427    2690 50.4% 27-May-94 21:47:46  Mtools-2.0.7/src/init.o
  204.      907     469 48.2% 26-May-94 17:29:12  Mtools-2.0.7/src/is_dir.c
  205.      434     273 37.0% 27-May-94 20:58:40  Mtools-2.0.7/src/is_dir.o
  206.     7599    1815 76.1% 27-May-94 18:59:48  Mtools-2.0.7/src/Makefile
  207.     1657     622 62.4% 26-May-94 17:29:12  Mtools-2.0.7/src/match.c
  208.      356     276 22.4% 27-May-94 20:56:08  Mtools-2.0.7/src/match.o
  209.     1294     667 48.4% 26-May-94 17:29:10  Mtools-2.0.7/src/Mattrib.1
  210.     3632    1444 60.2% 26-May-94 17:29:08  Mtools-2.0.7/src/mattrib.c
  211.     1933    1083 43.9% 27-May-94 20:54:40  Mtools-2.0.7/src/mattrib.o
  212.      967     524 45.8% 26-May-94 17:29:10  Mtools-2.0.7/src/Mcd.1
  213.     2639    1145 56.6% 26-May-94 17:29:12  Mtools-2.0.7/src/mcd.c
  214.     1989     975 50.9% 27-May-94 20:58:34  Mtools-2.0.7/src/mcd.o
  215.     1736     839 51.6% 26-May-94 17:29:10  Mtools-2.0.7/src/Mcopy.1
  216.     4617    1848 59.9% 26-May-94 17:29:08  Mtools-2.0.7/src/mcopy.c
  217.     2803    1528 45.4% 27-May-94 20:59:00  Mtools-2.0.7/src/mcopy.o
  218.      906     528 41.7% 26-May-94 17:29:10  Mtools-2.0.7/src/Mdel.1
  219.     3823    1601 58.1% 26-May-94 17:29:08  Mtools-2.0.7/src/mdel.c
  220.     2304    1228 46.7% 27-May-94 20:59:16  Mtools-2.0.7/src/mdel.o
  221.     1044     571 45.3% 26-May-94 17:29:10  Mtools-2.0.7/src/Mdir.1
  222.     7059    2564 63.6% 26-May-94 17:29:10  Mtools-2.0.7/src/mdir.c
  223.     4036    2029 49.7% 27-May-94 20:59:48  Mtools-2.0.7/src/mdir.o
  224.      918     498 45.7% 26-May-94 17:29:10  Mtools-2.0.7/src/Mformat.1
  225.     6144    2153 64.9% 26-May-94 17:29:12  Mtools-2.0.7/src/mformat.c
  226.     3623    1843 49.1% 27-May-94 21:00:16  Mtools-2.0.7/src/mformat.o
  227.     1570     744 52.6% 26-May-94 17:29:12  Mtools-2.0.7/src/Mkmanifest.1
  228.     2306    1086 52.9% 26-May-94 17:29:12  Mtools-2.0.7/src/mkmanifest.c
  229.     1386     843 39.1% 27-May-94 21:03:08  Mtools-2.0.7/src/mkmanifest.o
  230.      701     379 45.9% 26-May-94 17:29:10  Mtools-2.0.7/src/Mlabel.1
  231.     3079    1356 55.9% 26-May-94 17:29:10  Mtools-2.0.7/src/mlabel.c
  232.     2186    1164 46.7% 27-May-94 21:00:32  Mtools-2.0.7/src/mlabel.o
  233.     1124     603 46.3% 26-May-94 17:29:10  Mtools-2.0.7/src/Mmd.1
  234.     5375    2071 61.4% 26-May-94 17:29:08  Mtools-2.0.7/src/mmd.c
  235.     3003    1567 47.8% 27-May-94 21:00:52  Mtools-2.0.7/src/mmd.o
  236.      783     456 41.7% 26-May-94 17:29:10  Mtools-2.0.7/src/Mrd.1
  237.     4544    1835 59.6% 26-May-94 17:29:08  Mtools-2.0.7/src/mrd.c
  238.     2575    1344 47.8% 27-May-94 21:01:10  Mtools-2.0.7/src/mrd.o
  239.     1371     696 49.2% 26-May-94 17:29:10  Mtools-2.0.7/src/Mread.1
  240.     8159    2965 63.6% 26-May-94 17:29:08  Mtools-2.0.7/src/mread.c
  241.     4002    2245 43.9% 27-May-94 21:01:36  Mtools-2.0.7/src/mread.o
  242.     1268     651 48.6% 26-May-94 17:29:10  Mtools-2.0.7/src/Mren.1
  243.     3089    1338 56.6% 26-May-94 17:29:10  Mtools-2.0.7/src/mren.c
  244.     2118    1088 48.6% 27-May-94 21:02:02  Mtools-2.0.7/src/mren.o
  245.     2049     814 60.2% 26-May-94 17:29:12  Mtools-2.0.7/src/msdos.h
  246.     2798    1344 51.9% 26-May-94 17:29:08  Mtools-2.0.7/src/Mtools.1
  247.      981     553 43.6% 26-May-94 17:29:10  Mtools-2.0.7/src/Mtype.1
  248.     3157    1360 56.9% 26-May-94 17:29:08  Mtools-2.0.7/src/mtype.c
  249.     1856    1056 43.1% 27-May-94 21:02:18  Mtools-2.0.7/src/mtype.o
  250.     1649     809 50.9% 26-May-94 17:29:10  Mtools-2.0.7/src/Mwrite.1
  251.     7991    2886 63.8% 26-May-94 17:29:08  Mtools-2.0.7/src/mwrite.c
  252.     4511    2264 49.8% 27-May-94 21:02:44  Mtools-2.0.7/src/mwrite.o
  253.     2194     792 63.9% 26-May-94 17:29:12  Mtools-2.0.7/src/parse.c
  254.     1109     626 43.5% 27-May-94 20:56:18  Mtools-2.0.7/src/parse.o
  255.       48      48  0.0% 26-May-94 17:29:08  Mtools-2.0.7/src/patchlevel.h
  256.     2745    1415 48.4% 26-May-94 17:29:10  Mtools-2.0.7/src/Readme
  257.     3938    1678 57.3% 26-May-94 17:29:08  Mtools-2.0.7/src/Release.notes
  258.     2167     955 55.9% 26-May-94 17:29:12  Mtools-2.0.7/src/subdir.c
  259.     1065     650 38.9% 27-May-94 20:56:28  Mtools-2.0.7/src/subdir.o
  260.     4765    2176 54.3% 28-May-94 11:54:28  Mtools-2.0.7/Amiga_Mtools.ReadMe
  261. -------- ------- ----- --------- --------
  262.   506022  255407 49.5% 29-May-94 20:33:46   118 files
  263.